@towry/mcp 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @towry/mcp
 
-MCP (Model Context Protocol) server for Knowledge Graph document management and Tmux pane control.
+MCP (Model Context Protocol) server for fast semantic codebase search.
 
 ## Installation
 
@@ -10,20 +10,12 @@ pnpm add @towry/mcp
 npm install @towry/mcp
 ```
 
-## Environment Variables
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `KG_API_URL` | Knowledge Graph API base URL | `http://localhost:8361` |
-| `KG_API_KEY` | API authentication key | `kg-dev-api-key` |
-| `KG_API_TOKEN` | Alternative to KG_API_KEY | - |
-
 ## Usage
 
 ### As a CLI
 
 ```bash
-KG_API_URL=http://localhost:8361 pnpm dlx @towry/mcp
+pnpm dlx @towry/mcp
 ```
 
 ### With Claude Desktop
@@ -33,13 +25,9 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
 ```json
 {
   "mcpServers": {
-    "towry-mcp-kg": {
+    "towry-mcp": {
       "command": "npx",
-      "args": ["@towry/mcp"],
-      "env": {
-        "KG_API_URL": "http://localhost:8361",
-        "KG_API_KEY": "your-api-key"
-      }
+      "args": ["@towry/mcp"]
     }
   }
 }
@@ -47,116 +35,15 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
 
 ## Available Tools
 
-### `kg_create_doc`
-
-Create or update a document in the knowledge graph.
-
-**Parameters:**
-- `title` (string, required): Document title
-- `body` (string, required): Document content
-- `doc_type` (enum, required): `note` | `doc` | `task` | `plan` | `agent_session`
-- `id` (string, optional): UUID to update existing doc
-- `project_repo` (string, optional): Project repo (owner/repo)
-- `tags` (string[], optional): Tags for categorization
-- `status` (enum, optional): `pending` | `in_progress` | `done` | `blocked` (for tasks)
-- `parent_id` (string, optional): Parent document ID for hierarchy
-
-### `kg_get_doc`
-
-Get full document by ID.
-
-**Parameters:**
-- `id` (string, required): Document UUID
-
-### `kg_delete_doc`
-
-Delete a document from the knowledge graph.
-
-**Parameters:**
-- `id` (string, required): Document UUID to delete
-
-### `kg_search`
-
-Search documents with filters.
-
-**Parameters:**
-- `q` (string, optional): Search query
-- `doc_type` (enum, optional): Filter by document type
-- `project_repo` (string, optional): Filter by project repo
-- `status` (enum, optional): Filter by task status
-- `tag` (string, optional): Filter by tag
-- `limit` (number, optional): Max results (1-100, default: 20)
-- `offset` (number, optional): Pagination offset (default: 0)
-
-### `kg_semantic_search`
-
-Semantic search using embeddings.
-
-**Parameters:**
-- `q` (string, required): Search query
-- `embedding_keywords` (string[], optional): Keywords for embedding search
-- `doc_type` (enum, optional): Filter by document type
-- `project_repo` (string, optional): Filter by project repo
-- `tag` (string, optional): Filter by tag
-- `limit` (number, optional): Max results (1-20, default: 5)
-
-### `kg_status`
-
-Get document statistics: total count, breakdown by type and repo.
-
-**Parameters:** None
-
-## Document Types
-
-| Type | Use Case |
-|------|----------|
-| `note` | Session-specific learnings, debugging discoveries (ephemeral) |
-| `doc` | Curated reference docs meant to be maintained (stable) |
-| `task` | Actionable items with status tracking |
-| `plan` | Multi-step roadmaps with phases |
-| `agent_session` | Chat session logs |
-
-## Tmux Tools
-
-### `tmux_list_panes`
-
-List all tmux panes.
-
-**Parameters:** None
-
-### `tmux_send`
-
-Send keys to a tmux pane.
-
-**Parameters:**
-- `pane` (string, optional): Target pane ID. Defaults to `PI_MASTER_PANE` env if set
-- `keys` (string, required): Keys to send
-- `enter` (boolean, optional): Send Enter after (default: true)
-
-### `tmux_kill_pane`
-
-Kill a tmux pane by ID.
-
-**Parameters:**
-- `pane` (string, required): Pane ID in `%N` format (e.g., `%886`)
-
-### `tmux_capture`
-
-Capture the content of a tmux pane.
-
-**Parameters:**
-- `pane` (string, required): Target pane ID to capture
-- `lines` (number, optional): Number of lines to capture from end (default: 10)
-- `filter` (string, optional): Grep pattern (case-insensitive, extended regex)
-
-### `tmux_run`
+### `grep_fast`
 
-Run a command in a new tmux pane with duplicate detection.
+Fast semantic codebase search. It first narrows files by `keywords` and `filePatterns`, then runs `sgrep` on the filtered set.
 
 **Parameters:**
-- `command` (string, required): Command to run
-- `name` (string, optional): Unique identifier for duplicate detection
-- `cwd` (string, optional): Working directory for the command
+- `cwd` (string, required): Working directory to search in
+- `keywords` (string[], required): Specific grep patterns such as `"login|signin"`
+- `filePatterns` (string[], required): Specific filename globs such as `"*auth*"`
+- `semanticQuery` (string, required): Natural-language query for semantic search
 
 ## Development
 
@@ -187,8 +74,8 @@ The [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) is a b
 # Using the package script (recommended)
 pnpm inspect
 
-# Or manually with environment variables
-pnpm dlx @modelcontextprotocol/inspector -e KG_API_URL=http://localhost:8361 -e KG_API_KEY=your-key node dist/index.js
+# Or manually
+pnpm dlx @modelcontextprotocol/inspector node dist/index.js
 
 # Debug in watch mode (rebuild first, then run inspector)
 pnpm build && npx @modelcontextprotocol/inspector node dist/index.js
@@ -226,7 +113,7 @@ pnpm dlx @modelcontextprotocol/inspector --cli node dist/index.js
 - **Check tool schemas**: Use the Tools tab to verify parameter types and descriptions
 - **Test edge cases**: Try empty inputs, invalid types, missing required fields
 - **Monitor errors**: Watch the Notifications pane for server-side errors
-- **Verify API connectivity**: Test `kg_status` first to ensure the KG API is reachable
+- **Verify search flow**: Test `grep_fast` with a small repository and focused keywords first
 
 ## License
 

package/dist/checkpoints.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Checkpoints - Branch-scoped task recording for agent context continuity
+ *
+ * Provides tools for recording and retrieving task checkpoints:
+ * - record_checkpoint: Append a task summary to branch-scoped JSONL
+ * - list_checkpoints: Query checkpoints by time, branch, or keywords
+ *
+ * Storage: `<repo-root>/.agents/checkpoints/<sanitized-branch>.jsonl`
+ *
+ * Keywords: checkpoint, task-history, agent-memory, context-continuity
+ */
+import { z } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function countSentences(text: string): number;
+export declare const SummarySchema: z.ZodString;
+export declare function registerCheckpointTools(server: McpServer): void;
+//# sourceMappingURL=checkpoints.d.ts.map

package/dist/checkpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.d.ts","sourceRoot":"","sources":["../src/checkpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,eAAO,MAAM,aAAa,aAM0B,CAAC;AA6KrD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoM/D"}

package/dist/checkpoints.js

@@ -0,0 +1,358 @@
+/**
+ * Checkpoints - Branch-scoped task recording for agent context continuity
+ *
+ * Provides tools for recording and retrieving task checkpoints:
+ * - record_checkpoint: Append a task summary to branch-scoped JSONL
+ * - list_checkpoints: Query checkpoints by time, branch, or keywords
+ *
+ * Storage: `<repo-root>/.agents/checkpoints/<sanitized-branch>.jsonl`
+ *
+ * Keywords: checkpoint, task-history, agent-memory, context-continuity
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+import { z } from "zod";
+// ============================================================================
+// Types
+// ============================================================================
+export function countSentences(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return 0;
+    const matches = trimmed.match(/[^.!?]+[.!?]+/g);
+    if (!matches)
+        return 1;
+    return matches.length;
+}
+export const SummarySchema = z
+    .string()
+    .refine((value) => {
+    const sentenceCount = countSentences(value);
+    return sentenceCount >= 2 && sentenceCount <= 4;
+}, "Summary must contain 2-4 sentences.")
+    .describe("What was accomplished (2-4 sentences)");
+const ReferenceSchema = z.object({
+    kind: z
+        .enum(["file", "doc", "url", "issue", "pr"])
+        .describe("Reference type"),
+    title: z.string().describe("Human-readable title"),
+    ref: z.string().describe("Path, URL, or identifier"),
+});
+const CheckpointSchema = z.object({
+    timestamp: z.string().describe("ISO 8601 timestamp"),
+    branch: z.string().describe("Git branch name or 'default'"),
+    task: z.string().describe("Short task description"),
+    summary: SummarySchema,
+    files: z.array(z.string()).optional().describe("Modified files"),
+    references: z
+        .array(ReferenceSchema)
+        .optional()
+        .describe("Referenced docs/files/URLs"),
+    tags: z.array(z.string()).optional().describe("Categorization tags"),
+    sessionId: z.string().optional().describe("Optional session identifier"),
+    note: z.string().optional().describe("Optional follow-up note"),
+    // Reserved for future git hook integration
+    commit: z
+        .object({
+        hash: z.string(),
+        message: z.string(),
+    })
+        .optional()
+        .describe("Git commit info (populated by hooks)"),
+});
+// ============================================================================
+// Time Utilities
+// ============================================================================
+const RELATIVE_TIME_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),
+};
+function parseRelativeTime(alias) {
+    const fn = RELATIVE_TIME_ALIASES[alias.toLowerCase()];
+    return fn ? fn() : null;
+}
+// ============================================================================
+// Git Utilities
+// ============================================================================
+function getCurrentBranch(cwd) {
+    try {
+        const branch = execSync("git rev-parse --abbrev-ref HEAD", {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        return branch || "default";
+    }
+    catch {
+        return "default";
+    }
+}
+function getGitRoot(cwd) {
+    try {
+        return execSync("git rev-parse --show-toplevel", {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+    }
+    catch {
+        return cwd;
+    }
+}
+function sanitizeBranchName(branch) {
+    // Replace slashes and special chars with underscores for safe filenames
+    return branch.replace(/[/\\:*?"<>|]/g, "_").replace(/_+/g, "_");
+}
+// ============================================================================
+// Storage
+// ============================================================================
+function getCheckpointsDir(repoRoot) {
+    const dir = path.join(repoRoot, ".agents", "checkpoints");
+    fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function getCheckpointFilePath(repoRoot, branch) {
+    const dir = getCheckpointsDir(repoRoot);
+    const safeName = sanitizeBranchName(branch);
+    return path.join(dir, `${safeName}.jsonl`);
+}
+function appendCheckpoint(repoRoot, branch, checkpoint) {
+    const filePath = getCheckpointFilePath(repoRoot, branch);
+    const line = JSON.stringify(checkpoint);
+    fs.appendFileSync(filePath, line + "\n", "utf-8");
+    return filePath;
+}
+function readCheckpoints(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.trim().split("\n").filter(Boolean);
+    return lines.map((line) => JSON.parse(line));
+}
+// ============================================================================
+// Filtering
+// ============================================================================
+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 filterByQuery(checkpoints, query) {
+    const q = query.toLowerCase();
+    return checkpoints.filter((cp) => {
+        // Search in task, summary, tags
+        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;
+        // Search in references
+        if (cp.references?.some((r) => r.title.toLowerCase().includes(q) || r.ref.toLowerCase().includes(q))) {
+            return true;
+        }
+        return false;
+    });
+}
+// ============================================================================
+// MCP Tool Registration
+// ============================================================================
+export function registerCheckpointTools(server) {
+    // Tool: record_checkpoint
+    server.registerTool("record_checkpoint", {
+        description: `Record a task checkpoint to a branch-scoped JSONL file.
+
+Call this at the end of a task session to leave context for future sessions.
+
+Parameters:
+- task: Short task description (e.g., "implement login form")
+- summary: What was accomplished (2-4 sentences)
+- references: Optional array of {kind, title, ref} for docs/files/URLs consulted
+- files: Optional array of modified file paths
+- tags: Optional array of categorization tags
+- note: Optional follow-up note`,
+        inputSchema: {
+            task: z.string().describe("Short task description"),
+            summary: SummarySchema,
+            references: z
+                .array(ReferenceSchema)
+                .optional()
+                .describe("Referenced docs/files/URLs"),
+            files: z.array(z.string()).optional().describe("Modified files"),
+            tags: z.array(z.string()).optional().describe("Categorization tags"),
+            sessionId: z.string().optional().describe("Session identifier"),
+            note: z.string().optional().describe("Follow-up note"),
+            timestamp: z
+                .string()
+                .optional()
+                .describe("Override timestamp (ISO 8601)"),
+        },
+    }, async (params) => {
+        const cwd = process.cwd();
+        const branch = getCurrentBranch(cwd);
+        const timestamp = params.timestamp ?? new Date().toISOString();
+        const checkpoint = {
+            timestamp,
+            branch,
+            task: params.task,
+            summary: params.summary,
+            files: params.files,
+            references: params.references,
+            tags: params.tags,
+            sessionId: params.sessionId,
+            note: params.note,
+        };
+        try {
+            const filePath = appendCheckpoint(cwd, branch, checkpoint);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Checkpoint recorded.\n- Branch: ${branch}\n- File: ${filePath}\n- Timestamp: ${timestamp}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    { type: "text", text: `Failed to record checkpoint: ${msg}` },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Tool: list_checkpoints
+    server.registerTool("list_checkpoints", {
+        description: `List checkpoints from branch-scoped JSONL files.
+
+Supports time filtering via ISO dates or natural aliases:
+- relativeTime: "today", "yesterday", "last_1h", "last_24h", "last_7d", "last_30d"
+- since/until: ISO 8601 dates for precise range
+
+Query searches in task, summary, tags, and reference titles/refs.
+
+Parameters:
+- cwd: Repository root directory (optional; defaults to current git root)
+- branch: Target branch (defaults to current branch)
+- query: Optional keyword filter
+- since/until: ISO 8601 time range, recommend to use relativeTime.
+- relativeTime: Natural time alias
+- limit: Max results (default 5)`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .optional()
+                .describe("Repository root directory (default: current git root)"),
+            branch: z
+                .string()
+                .optional()
+                .describe("Target branch (default: current)"),
+            query: z.string().optional().describe("Keyword filter"),
+            since: z.string().optional().describe("Start time (ISO 8601)"),
+            until: z.string().optional().describe("End time (ISO 8601)"),
+            relativeTime: z
+                .enum([
+                "today",
+                "yesterday",
+                "last_1h",
+                "last_24h",
+                "last_7d",
+                "last_30d",
+            ])
+                .optional()
+                .describe("Recommend: Natural time alias"),
+            limit: z
+                .number()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe("Max results (default 5)"),
+        },
+    }, async (params) => {
+        const cwd = params.cwd ?? getGitRoot(process.cwd());
+        const branch = params.branch ?? getCurrentBranch(cwd);
+        const filePath = getCheckpointFilePath(cwd, branch);
+        let checkpoints = readCheckpoints(filePath);
+        // Time filtering
+        let since;
+        let until;
+        if (params.relativeTime) {
+            since = parseRelativeTime(params.relativeTime) ?? undefined;
+        }
+        if (params.since) {
+            since = new Date(params.since);
+        }
+        if (params.until) {
+            until = new Date(params.until);
+        }
+        if (since || until) {
+            checkpoints = filterByTime(checkpoints, since, until);
+        }
+        // Query filtering
+        if (params.query) {
+            checkpoints = filterByQuery(checkpoints, params.query);
+        }
+        // Limit and sort (newest first)
+        const limit = params.limit ?? 10;
+        checkpoints = checkpoints.reverse().slice(0, limit);
+        if (checkpoints.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No checkpoints found for branch "${branch}".`,
+                    },
+                ],
+            };
+        }
+        // Format output
+        const lines = [`## Checkpoints (${branch})\n`];
+        for (const cp of checkpoints) {
+            lines.push(`### ${cp.timestamp}`);
+            lines.push(`**Task**: ${cp.task}`);
+            lines.push(`**Summary**: ${cp.summary}`);
+            if (cp.files?.length) {
+                lines.push(`**Files**: ${cp.files.join(", ")}`);
+            }
+            if (cp.references?.length) {
+                lines.push(`**References**:`);
+                for (const ref of cp.references) {
+                    lines.push(`  - [${ref.kind}] ${ref.title}: ${ref.ref}`);
+                }
+            }
+            if (cp.tags?.length) {
+                lines.push(`**Tags**: ${cp.tags.join(", ")}`);
+            }
+            if (cp.note) {
+                lines.push(`**Note**: ${cp.note}`);
+            }
+            lines.push("");
+        }
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    });
+}
+//# sourceMappingURL=checkpoints.js.map

package/dist/checkpoints.js.map

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

package/dist/checkpoints.test.d.ts

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

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

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

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 & Grep MCP Server
+ * @towry/mcp - Grep MCP Server
  *
  * Provides tools for:
- * - Document management in a knowledge graph
  * - 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, grep, 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"}

package/dist/index.js

@@ -1,194 +1,28 @@
 #!/usr/bin/env node
 /**
- * @towry/mcp - Knowledge Graph & Grep MCP Server
+ * @towry/mcp - Grep MCP Server
  *
  * Provides tools for:
- * - Document management in a knowledge graph
  * - 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, grep, ai-tools, llm-server
+ * Keywords: mcp, grep, ai-tools, llm-server
  */
-import { z } from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { registerGrepFastTools } from "./grep-fast.js";
-// ============================================================================
-// Knowledge Graph Types
-// ============================================================================
-const DocTypeEnum = z.enum(["note", "doc", "task", "plan", "agent_session"]);
-const TaskStatusEnum = z.enum(["pending", "in_progress", "done", "blocked"]);
-// ============================================================================
-// Knowledge Graph API Client
-// ============================================================================
-function getKgBaseUrl() {
-    return process.env.KG_API_URL ?? "http://localhost:8361";
-}
-function getKgApiKey() {
-    return process.env.KG_API_KEY ?? process.env.KG_API_TOKEN ?? "kg-dev-api-key";
-}
-async function kgApiRequest(method, path, body) {
-    const url = `${getKgBaseUrl()}${path}`;
-    const headers = {
-        "X-API-Key": getKgApiKey(),
-        "Content-Type": "application/json",
-    };
-    const res = await fetch(url, {
-        method,
-        headers,
-        body: body ? JSON.stringify(body) : undefined,
-    });
-    if (!res.ok) {
-        const text = await res.text();
-        throw new Error(`API error ${res.status}: ${text}`);
-    }
-    return res.json();
-}
+import { registerCheckpointTools } from "./checkpoints.js";
 // ============================================================================
 // MCP Server
 // ============================================================================
 const server = new McpServer({
     name: "towry-mcp",
-    version: "0.2.0",
-});
-// ============================================================================
-// Knowledge Graph Tools
-// ============================================================================
-// kg_create_doc - Create or update a document
-server.registerTool("kg_create_doc", {
-    description: "Create or update a document. Use 'note' for session learnings (ephemeral), 'doc' for stable reference docs, 'plan' for roadmaps, 'task' for actionable items. For insights from current chat, prefer kg_insight_save.",
-    inputSchema: {
-        title: z.string().describe("Document title"),
-        body: z.string().describe("Document content"),
-        doc_type: DocTypeEnum.describe("note: session learnings (ephemeral), doc: stable reference, task: actionable items, plan: roadmaps, agent_session: chat logs"),
-        id: z.string().optional().describe("UUID to update existing doc"),
-        project_repo: z.string().optional().describe("Project repo (owner/repo)"),
-        tags: z.array(z.string()).optional().describe("Tags for categorization"),
-        status: TaskStatusEnum.optional().describe("Task status (only for task type)"),
-        parent_id: z
-            .string()
-            .optional()
-            .describe("Parent document ID for hierarchy"),
-    },
-}, async (params) => {
-    const result = await kgApiRequest("POST", "/api/docs", {
-        ...params,
-        doc_type: params.doc_type ?? "note",
-    });
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
-});
-// kg_get_doc - Get full document by ID
-server.registerTool("kg_get_doc", {
-    description: "Get full document by ID. Use AFTER kg_search when you need the complete body (snippets are truncated).",
-    inputSchema: {
-        id: z.string().describe("Document UUID"),
-    },
-}, async (params) => {
-    const result = await kgApiRequest("GET", `/api/docs/${params.id}`);
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
-});
-// kg_delete_doc - Delete a document
-server.registerTool("kg_delete_doc", {
-    description: "Delete a document from the knowledge graph.",
-    inputSchema: {
-        id: z.string().describe("Document UUID to delete"),
-    },
-}, async (params) => {
-    const result = await kgApiRequest("DELETE", `/api/docs/${params.id}`);
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
-});
-// kg_search - Search documents
-server.registerTool("kg_search", {
-    description: "Find plans, tasks, or docs. Use doc_type='plan' for plans, tag='insight' for insights. Returns snippets - use kg_get_doc for full content.",
-    inputSchema: {
-        q: z
-            .string()
-            .optional()
-            .describe("Search query (optional - omit to list all of doc_type)"),
-        doc_type: DocTypeEnum.optional().describe("Filter by type: 'plan' for plans, 'note' for insights/learnings"),
-        project_repo: z.string().optional().describe("Filter by project repo"),
-        status: TaskStatusEnum.optional().describe("Filter by task status"),
-        tag: z.string().optional().describe("Filter by tag"),
-        limit: z.number().int().min(1).max(100).default(20).optional(),
-        offset: z.number().int().min(0).default(0).optional(),
-    },
-}, async (params) => {
-    const searchParams = new URLSearchParams();
-    if (params.q)
-        searchParams.set("q", params.q);
-    if (params.doc_type)
-        searchParams.set("doc_type", params.doc_type);
-    if (params.project_repo)
-        searchParams.set("project_repo", params.project_repo);
-    if (params.status)
-        searchParams.set("status", params.status);
-    if (params.tag)
-        searchParams.set("tag", params.tag);
-    if (params.limit)
-        searchParams.set("limit", String(params.limit));
-    if (params.offset)
-        searchParams.set("offset", String(params.offset));
-    const result = await kgApiRequest("GET", `/api/docs/search?${searchParams.toString()}`);
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
-});
-// kg_semantic_search - Semantic search using embeddings
-server.registerTool("kg_semantic_search", {
-    description: "Semantic search using embeddings in the knowledge graph.",
-    inputSchema: {
-        q: z.string().describe("Search query (required)"),
-        embedding_keywords: z
-            .array(z.string())
-            .optional()
-            .describe("Keywords for embedding search. If provided, searches with these keywords. If not, fetches latest 2 docs."),
-        doc_type: DocTypeEnum.optional().describe("Filter by document type"),
-        project_repo: z.string().optional().describe("Filter by project repo"),
-        tag: z.string().optional().describe("Filter by tag"),
-        limit: z.number().int().min(1).max(20).default(5).optional(),
-    },
-}, async (params) => {
-    const searchParams = new URLSearchParams();
-    const searchQuery = params.embedding_keywords && params.embedding_keywords.length > 0
-        ? params.embedding_keywords.join(" ")
-        : params.q;
-    searchParams.set("q", searchQuery);
-    if (params.doc_type)
-        searchParams.set("doc_type", params.doc_type);
-    if (params.project_repo)
-        searchParams.set("project_repo", params.project_repo);
-    if (params.tag)
-        searchParams.set("tag", params.tag);
-    if (params.limit)
-        searchParams.set("limit", String(params.limit));
-    const result = await kgApiRequest("GET", `/api/docs/semantic?${searchParams.toString()}`);
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
-});
-// kg_status - Get document statistics
-server.registerTool("kg_status", {
-    description: "Get document statistics: total count, breakdown by type (plan/task/doc/note) and by repo. Use to check what's stored before searching.",
-    inputSchema: {},
-}, async () => {
-    const result = await kgApiRequest("GET", "/api/docs/status");
-    return {
-        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-    };
+    version: "0.3.0",
 });
 // ============================================================================
-// Grep Fast Tools
+// Tools Registration
 // ============================================================================
 registerGrepFastTools(server);
+registerCheckpointTools(server);
 // ============================================================================
 // Start Server
 // ============================================================================

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;AAC7E,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAyE7E,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,uBAAuB,CAAC;AAC3D,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,gBAAgB,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAAc,EACd,IAAY,EACZ,IAAc;IAEd,MAAM,GAAG,GAAG,GAAG,YAAY,EAAE,GAAG,IAAI,EAAE,CAAC;IACvC,MAAM,OAAO,GAA2B;QACtC,WAAW,EAAE,WAAW,EAAE;QAC1B,cAAc,EAAE,kBAAkB;KACnC,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM;QACN,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9C,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;AAClC,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,8CAA8C;AAC9C,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;IACE,WAAW,EACT,uNAAuN;IACzN,WAAW,EAAE;QACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAC7C,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAC5B,8HAA8H,CAC/H;QACD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACjE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACxE,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxC,kCAAkC,CACnC;QACD,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kCAAkC,CAAC;KAChD;CACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,MAAM,GAAG,MAAM,YAAY,CAAoB,MAAM,EAAE,WAAW,EAAE;QACxE,GAAG,MAAM;QACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM;KACpC,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;IACE,WAAW,EACT,wGAAwG;IAC1G,WAAW,EAAE;QACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;KACzC;CACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,MAAM,GAAG,MAAM,YAAY,CAAQ,KAAK,EAAE,aAAa,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;IACE,WAAW,EAAE,6CAA6C;IAC1D,WAAW,EAAE;QACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;KACnD;CACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,QAAQ,EACR,aAAa,MAAM,CAAC,EAAE,EAAE,CACzB,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,+BAA+B;AAC/B,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;IACE,WAAW,EACT,4IAA4I;IAC9I,WAAW,EAAE;QACX,CAAC,EAAE,CAAC;aACD,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;QACrE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACvC,iEAAiE,CAClE;QACD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACtE,MAAM,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;QACnE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KACtD;CACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,CAAC;QAAE,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,QAAQ;QAAE,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,YAAY;QACrB,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM;QAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,GAAG;QAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,KAAK;QAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM;QAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,KAAK,EACL,oBAAoB,YAAY,CAAC,QAAQ,EAAE,EAAE,CAC9C,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,wDAAwD;AACxD,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;IACE,WAAW,EAAE,0DAA0D;IACvE,WAAW,EAAE;QACX,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACjD,kBAAkB,EAAE,CAAC;aAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjB,QAAQ,EAAE;aACV,QAAQ,CACP,0GAA0G,CAC3G;QACH,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACpE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACtE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;QACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7D;CACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAE3C,MAAM,WAAW,GACf,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;QAC/D,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC;QACrC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAEf,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,QAAQ;QAAE,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,YAAY;QACrB,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,GAAG;QAAE,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,KAAK;QAAE,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAElE,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,KAAK,EACL,sBAAsB,YAAY,CAAC,QAAQ,EAAE,EAAE,CAChD,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,sCAAsC;AACtC,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;IACE,WAAW,EACT,wIAAwI;IAC1I,WAAW,EAAE,EAAE;CAChB,EACD,KAAK,IAAI,EAAE;IACT,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,KAAK,EACL,kBAAkB,CACnB,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAE9B,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAEhC,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@towry/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server implementation",
   "type": "module",
   "main": "./dist/index.js",