@eeymoo/context-todos 0.1.0-alpha.0

package/README.md

@@ -0,0 +1,261 @@
+# Context-Todos
+
+[简体中文](./README_ZH.md) | English
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that scans and manages TODO/FIXME/HACK/XXX comments in your codebase.
+
+## What It Does
+
+Context-Todos helps you track and manage code annotations across your entire project. It scans source files for common comment tags and provides tools to query, watch, and analyze them through the MCP protocol.
+
+### Features
+
+- **Scan Files**: Extract TODO comments from a single file
+- **Scan Directories**: Recursively scan all supported files in a directory
+- **List Extensions**: View all supported file extensions
+- **Watch Mode**: Real-time monitoring of file changes (max/labs mode)
+- **TODO Database**: Persistent storage of all TODO items (max/labs mode)
+- **Statistics**: Get TODO statistics by tag and file (labs mode)
+
+### Supported TODO Tags
+
+| Tag | Usage |
+|-----|-------|
+| `TODO` | General tasks to be done |
+| `FIXME` | Code that needs to be fixed |
+| `HACK` | Temporary workarounds |
+| `XXX` | Warning or problematic code |
+
+### Supported File Extensions
+
+| Category | Extensions |
+|----------|------------|
+| JavaScript/TypeScript | `.ts`, `.tsx`, `.js`, `.jsx`, `.mjs`, `.cjs` |
+| Python | `.py` |
+| Ruby | `.rb` |
+| Java | `.java` |
+| Go | `.go` |
+| Rust | `.rs` |
+| C/C++ | `.c`, `.cpp`, `.h`, `.hpp` |
+| C# | `.cs` |
+| PHP | `.php` |
+| Swift | `.swift` |
+| Kotlin/Scala | `.kt`, `.scala` |
+| Shell | `.sh`, `.bash` |
+| Frontend | `.css`, `.scss`, `.less`, `.html`, `.vue`, `.svelte` |
+| Config | `.yaml`, `.yml`, `.toml`, `.ini`, `.cfg` |
+| Database | `.sql`, `.lua` |
+| Other | `.r`, `.m`, `.mm`, `.pl`, `.pm`, `.ex`, `.exs`, `.erl`, `.hs`, `.elm`, `.clj`, `.cljs`, `.tf`, `.hcl`, `.dockerfile` |
+
+## How to Use
+
+### Quick Start (npx)
+
+```bash
+# Run directly with npx (Stable Standard)
+npx @eeymoo/context-todos mcp
+
+# Stable Max (with watching)
+npx @eeymoo/context-todos mcp --max
+
+# Labs Standard
+npx @eeymoo/context-todos mcp --labs
+
+# Labs Max (all features including experimental)
+npx @eeymoo/context-todos mcp --labs --max
+```
+
+### Installation
+
+```bash
+# Install globally
+npm install -g @eeymoo/context-todos
+
+# Or with pnpm
+pnpm add -g @eeymoo/context-todos
+
+# Then run
+context-todos mcp
+```
+
+### Configure MCP Client
+
+Add to your MCP client configuration (e.g., Claude Desktop, Cursor, etc.):
+
+```json
+{
+  "mcpServers": {
+    "context-todos": {
+      "command": "npx",
+      "args": ["-y", "@eeymoo/context-todos", "mcp"]
+    }
+  }
+}
+```
+
+Or with max/labs mode:
+
+```json
+{
+  "mcpServers": {
+    "context-todos": {
+      "command": "npx",
+      "args": ["-y", "@eeymoo/context-todos", "mcp", "--max"]
+    }
+  }
+}
+```
+
+### Development
+
+```bash
+# Clone the repository
+git clone https://github.com/eeymoo/context-todos.git
+cd context-todos
+
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run in development
+pnpm dev
+```
+
+### Server Modes
+
+The product has two categories of features:
+
+- **Stable**: Production-ready features with `Standard` and `Max` variants
+- **Labs**: Experimental features, also with `Standard` and `Max` variants
+
+| Category | Mode | CLI | Description | Tools |
+|----------|------|-----|-------------|-------|
+| Stable | Standard | (default) | Basic scanning tools | `scan-file`, `scan-directory`, `list-supported-extensions` |
+| Stable | Max | `--max` | Standard + file watching & database | All standard + `watch`, `unwatch`, `list-todos` |
+| Labs | Standard | `--labs` | Experimental standard mode | Same as Stable Standard |
+| Labs | Max | `--labs --max` | All features including experimental | All max + `get-todo-stats` |
+
+```bash
+# Stable Standard (default)
+npx @eeymoo/context-todos mcp
+
+# Stable Max (with watching)
+npx @eeymoo/context-todos mcp --max
+
+# Labs Standard
+npx @eeymoo/context-todos mcp --labs
+
+# Labs Max (all features)
+npx @eeymoo/context-todos mcp --labs --max
+```
+
+### MCP Tools
+
+#### `scan-file`
+
+Scan a single file for TODO comments.
+
+```json
+{
+  "name": "scan-file",
+  "arguments": {
+    "path": "/path/to/file.ts"
+  }
+}
+```
+
+#### `scan-directory`
+
+Recursively scan a directory for TODO comments.
+
+```json
+{
+  "name": "scan-directory",
+  "arguments": {
+    "path": "/path/to/project",
+    "extensions": [".ts", ".js"]
+  }
+}
+```
+
+#### `list-supported-extensions`
+
+List all supported file extensions.
+
+```json
+{
+  "name": "list-supported-extensions",
+  "arguments": {}
+}
+```
+
+#### `watch` (max / labs --max)
+
+Start watching a directory for file changes.
+
+```json
+{
+  "name": "watch",
+  "arguments": {
+    "path": "/path/to/project",
+    "extensions": [".ts", ".js"]
+  }
+}
+```
+
+#### `unwatch` (max / labs --max)
+
+Stop watching.
+
+```json
+{
+  "name": "unwatch",
+  "arguments": {}
+}
+```
+
+#### `list-todos` (max / labs --max)
+
+List all tracked TODOs from the database.
+
+```json
+{
+  "name": "list-todos",
+  "arguments": {
+    "tag": "TODO",
+    "file": "src/index.ts"
+  }
+}
+```
+
+#### `get-todo-stats` (labs --max only)
+
+Get TODO statistics grouped by tag and file.
+
+```json
+{
+  "name": "get-todo-stats",
+  "arguments": {}
+}
+```
+
+### Scripts
+
+```bash
+pnpm dev           # Run in development mode
+pnpm build         # Build for production
+pnpm test          # Run tests
+pnpm test:watch    # Run tests with watch mode
+pnpm inspector     # Run with MCP inspector (for debugging)
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- pnpm (recommended)
+
+## License
+
+ISC

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { createServer } from './mcp/index.js';
+import { createServer as createNodeHttpServer } from 'node:http';
+import { consola } from 'consola';
+const program = new Command();
+const logger = consola;
+program
+    .name('context-todos')
+    .description('AI context-aware TODO tracker')
+    .version('1.0.0');
+program
+    .command('mcp')
+    .description('Start MCP server')
+    .option('-p, --port <number>', 'Port to run the MCP server on (enables SSE mode)')
+    .option('-w, --watch <path>', 'Path to watch for changes', '.')
+    .option('--stdio', 'Force stdio mode instead of SSE')
+    .option('--max', 'Enable Max mode (watcher + database persistence)')
+    .option('--labs', 'Enable Labs mode (experimental features)')
+    .option('--use-gitignore', 'Use .gitignore to filter files', false)
+    .option('--gitignore-path <path>', 'Custom path to gitignore file (default: .gitignore)')
+    .action(async (options) => {
+    let mode;
+    if (options.labs && options.max) {
+        mode = 'labs-max';
+    }
+    else if (options.labs) {
+        mode = 'labs-standard';
+    }
+    else if (options.max) {
+        mode = 'max';
+    }
+    else {
+        mode = 'standard';
+    }
+    const useSSE = options.port !== undefined && !options.stdio;
+    const serverOptions = {
+        mode,
+        watchPath: options.watch,
+        useGitignore: options.useGitignore,
+        ...(options.gitignorePath && { gitignorePath: options.gitignorePath }),
+    };
+    const { server, totalTodos } = await createServer(serverOptions);
+    if (mode !== 'standard' && mode !== 'labs-standard') {
+        const modeMsg = mode === 'labs-max'
+            ? 'Starting in labs-max mode (all features + experimental)'
+            : 'Starting in max mode (watcher + database)';
+        logger.info(modeMsg);
+        logger.info(`Initial scan complete: ${totalTodos} TODO(s) persisted`);
+    }
+    if (useSSE) {
+        const port = Number(options.port);
+        let sseTransport;
+        const httpServer = createNodeHttpServer(async (req, res) => {
+            if (req.method === 'GET' && req.url === '/sse') {
+                sseTransport = new SSEServerTransport('/messages', res);
+                await server.connect(sseTransport);
+                return;
+            }
+            if (req.method === 'POST' && req.url === '/messages') {
+                if (!sseTransport) {
+                    res.writeHead(400);
+                    res.end('No SSE connection established');
+                    return;
+                }
+                const body = [];
+                req.on('data', (chunk) => body.push(chunk));
+                req.on('end', async () => {
+                    await sseTransport.handlePostMessage(req, res, Buffer.concat(body).toString());
+                });
+                return;
+            }
+            res.writeHead(404);
+            res.end('Not found');
+        });
+        httpServer.listen(port, () => {
+            logger.success(`SSE server running on http://localhost:${port}/sse`);
+        });
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/mcp/db.d.ts

@@ -0,0 +1,29 @@
+import { type Client } from '@libsql/client';
+import type { TodoItem } from './types.js';
+export declare function initDb(basePath?: string): Promise<Client>;
+export declare function getDb(): Client;
+export declare function syncFileTodos(file: string, todos: TodoItem[]): Promise<void>;
+export declare function removeFileTodos(file: string): Promise<void>;
+export interface TodoQuery {
+    tag?: string | undefined;
+    file?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}
+export declare function queryTodos(query?: TodoQuery): Promise<{
+    todos: TodoItem[];
+    total: number;
+}>;
+export interface TodoStats {
+    total: number;
+    byTag: {
+        tag: string;
+        count: number;
+    }[];
+    byFile: {
+        file: string;
+        count: number;
+    }[];
+}
+export declare function getTodoStats(): Promise<TodoStats>;
+//# sourceMappingURL=db.d.ts.map

package/dist/src/mcp/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../src/mcp/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,wBAAsB,MAAM,CAAC,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBpE;AAED,wBAAgB,KAAK,IAAI,MAAM,CAK9B;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,wBAAsB,UAAU,CAAC,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCrG;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAqBvD"}

package/dist/src/mcp/db.js

@@ -0,0 +1,111 @@
+import { createClient } from '@libsql/client';
+import { resolve } from 'node:path';
+const DB_FILE = '.context-todos.db';
+let client = null;
+export async function initDb(basePath = '.') {
+    const dbPath = resolve(basePath, DB_FILE);
+    client = createClient({ url: `file:${dbPath}` });
+    await client.batch([
+        `CREATE TABLE IF NOT EXISTS todos (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        file TEXT NOT NULL,
+        tag TEXT NOT NULL,
+        line INTEGER NOT NULL,
+        ref TEXT NOT NULL DEFAULT '',
+        text TEXT NOT NULL,
+        created_at INTEGER NOT NULL DEFAULT (unixepoch('now', 'subsec') * 1000),
+        updated_at INTEGER NOT NULL DEFAULT (unixepoch('now', 'subsec') * 1000),
+        UNIQUE(file, line, tag)
+      )`,
+        `CREATE INDEX IF NOT EXISTS idx_todos_file ON todos(file)`,
+        `CREATE INDEX IF NOT EXISTS idx_todos_tag ON todos(tag)`,
+        `CREATE INDEX IF NOT EXISTS idx_todos_updated ON todos(updated_at DESC)`,
+    ], 'write');
+    return client;
+}
+export function getDb() {
+    if (!client) {
+        throw new Error('Database not initialized. Call initDb() first.');
+    }
+    return client;
+}
+export async function syncFileTodos(file, todos) {
+    const db = getDb();
+    if (todos.length === 0) {
+        await db.execute({ sql: 'DELETE FROM todos WHERE file = ?', args: [file] });
+        return;
+    }
+    const tx = await db.transaction('write');
+    try {
+        await tx.execute({ sql: 'DELETE FROM todos WHERE file = ?', args: [file] });
+        for (const todo of todos) {
+            await tx.execute({
+                sql: `INSERT INTO todos (file, tag, line, ref, text, updated_at)
+              VALUES (?, ?, ?, ?, ?, unixepoch('now', 'subsec') * 1000)`,
+                args: [todo.file, todo.tag, todo.line, todo.ref || '', todo.text],
+            });
+        }
+        await tx.commit();
+    }
+    catch (err) {
+        await tx.rollback();
+        throw err;
+    }
+    finally {
+        tx.close();
+    }
+}
+export async function removeFileTodos(file) {
+    const db = getDb();
+    await db.execute({ sql: 'DELETE FROM todos WHERE file = ?', args: [file] });
+}
+export async function queryTodos(query = {}) {
+    const db = getDb();
+    const conditions = [];
+    const args = [];
+    if (query.tag) {
+        conditions.push('tag = ?');
+        args.push(query.tag);
+    }
+    if (query.file) {
+        conditions.push('file LIKE ?');
+        args.push(`%${query.file}%`);
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const countResult = await db.execute({
+        sql: `SELECT COUNT(*) as total FROM todos ${where}`,
+        args,
+    });
+    const total = Number(countResult.rows[0]?.total ?? 0);
+    const limit = query.limit ?? 100;
+    const offset = query.offset ?? 0;
+    const result = await db.execute({
+        sql: `SELECT file, tag, line, ref, text FROM todos ${where} ORDER BY updated_at DESC LIMIT ? OFFSET ?`,
+        args: [...args, limit, offset],
+    });
+    const todos = result.rows.map((row) => ({
+        file: String(row.file),
+        tag: String(row.tag),
+        line: Number(row.line),
+        ref: String(row.ref),
+        text: String(row.text),
+    }));
+    return { todos, total };
+}
+export async function getTodoStats() {
+    const db = getDb();
+    const results = await db.batch([
+        'SELECT COUNT(*) as total FROM todos',
+        'SELECT tag, COUNT(*) as count FROM todos GROUP BY tag ORDER BY count DESC',
+        'SELECT file, COUNT(*) as count FROM todos GROUP BY file ORDER BY count DESC LIMIT 20',
+    ], 'read');
+    const totalResult = results[0];
+    const tagResult = results[1];
+    const fileResult = results[2];
+    return {
+        total: Number(totalResult?.rows[0]?.total ?? 0),
+        byTag: (tagResult?.rows ?? []).map((r) => ({ tag: String(r.tag), count: Number(r.count) })),
+        byFile: (fileResult?.rows ?? []).map((r) => ({ file: String(r.file), count: Number(r.count) })),
+    };
+}
+//# sourceMappingURL=db.js.map

package/dist/src/mcp/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/mcp/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAEpC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,WAAmB,GAAG;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,QAAQ,MAAM,EAAE,EAAE,CAAC,CAAC;IAEjD,MAAM,MAAM,CAAC,KAAK,CAChB;QACE;;;;;;;;;;QAUE;QACF,0DAA0D;QAC1D,wDAAwD;QACxD,wEAAwE;KACzE,EACD,OAAO,CACR,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,KAAiB;IACjE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE5E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,OAAO,CAAC;gBACf,GAAG,EAAE;wEAC2D;gBAChE,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,kCAAkC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAmB,EAAE;IACpD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAwB,EAAE,CAAC;IAErC,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/E,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC;QACnC,GAAG,EAAE,uCAAuC,KAAK,EAAE;QACnD,IAAI;KACL,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC;QAC9B,GAAG,EAAE,gDAAgD,KAAK,4CAA4C;QACtG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;KAC/B,CAAC,CAAC;IAEH,MAAM,KAAK,GAAe,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;KACvB,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,KAAK,CAC5B;QACE,qCAAqC;QACrC,2EAA2E;QAC3E,sFAAsF;KACvF,EACD,MAAM,CACP,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9B,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QAC/C,KAAK,EAAE,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3F,MAAM,EAAE,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;KAChG,CAAC;AACJ,CAAC"}

package/dist/src/mcp/gitignore.d.ts

@@ -0,0 +1,6 @@
+export interface GitignoreFilter {
+    ignores(pathname: string): boolean;
+    ignoresDir(dirPath: string): boolean;
+}
+export declare function createGitignoreFilter(rootDir: string, gitignorePath?: string): GitignoreFilter;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/src/mcp/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../../src/mcp/gitignore.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAOD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAqB,GACnC,eAAe,CA0BjB"}

package/dist/src/mcp/gitignore.js

@@ -0,0 +1,32 @@
+import ignore from 'ignore';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve, relative } from 'node:path';
+const noopFilter = {
+    ignores: () => false,
+    ignoresDir: () => false,
+};
+export function createGitignoreFilter(rootDir, gitignorePath = '.gitignore') {
+    const absoluteGitignorePath = resolve(rootDir, gitignorePath);
+    if (!existsSync(absoluteGitignorePath)) {
+        return noopFilter;
+    }
+    const gitignoreContent = readFileSync(absoluteGitignorePath, 'utf8');
+    const ig = ignore().add(gitignoreContent);
+    return {
+        ignores: (pathname) => {
+            const relativePath = relative(rootDir, pathname);
+            if (!relativePath || relativePath.startsWith('..')) {
+                return false;
+            }
+            return ig.ignores(relativePath);
+        },
+        ignoresDir: (dirPath) => {
+            const relativePath = relative(rootDir, dirPath);
+            if (!relativePath || relativePath.startsWith('..')) {
+                return false;
+            }
+            return ig.ignores(relativePath) || ig.ignores(relativePath + '/');
+        },
+    };
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/src/mcp/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../../src/mcp/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAO9C,MAAM,UAAU,GAAoB;IAClC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;IACpB,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;CACxB,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,gBAAwB,YAAY;IAEpC,MAAM,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAE9D,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACvC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,gBAAgB,GAAG,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE1C,OAAO;QACL,OAAO,EAAE,CAAC,QAAgB,EAAE,EAAE;YAC5B,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;QACD,UAAU,EAAE,CAAC,OAAe,EAAE,EAAE;YAC9B,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,OAAO,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC;QACpE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/mcp/index.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerOptions } from './types.js';
+export declare function createServer(options?: ServerOptions): Promise<{
+    server: McpServer;
+    totalTodos: number;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAoC;;;GAmF/E"}

package/dist/src/mcp/index.js

@@ -0,0 +1,87 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { resolve, relative } from 'node:path';
+import { watch } from 'chokidar';
+import { registerScanFile } from './tools/scan-file.js';
+import { registerScanDirectory } from './tools/scan-directory.js';
+import { registerListExtensions } from './tools/list-extensions.js';
+import { registerWatchTools } from './tools/watch.js';
+import { registerListTodos } from './tools/list-todos.js';
+import { registerGetTodoStats } from './tools/get-todo-stats.js';
+import { initDb, syncFileTodos, removeFileTodos } from './db.js';
+import { collectFiles, scanFile } from './scanner.js';
+import { modeConfigs } from './types.js';
+import { createGitignoreFilter } from './gitignore.js';
+export async function createServer(options = { mode: 'standard' }) {
+    const { mode } = options;
+    const config = modeConfigs[mode];
+    const watchPath = resolve(options.watchPath ?? '.');
+    const gitignoreFilter = options.useGitignore
+        ? createGitignoreFilter(watchPath, options.gitignorePath)
+        : { ignores: () => false, ignoresDir: () => false };
+    const server = new McpServer({ name: 'context-todos', version: '1.0.0' }, { capabilities: { logging: {} } });
+    registerScanFile(server);
+    registerScanDirectory(server);
+    registerListExtensions(server);
+    if (config.enableWatcher) {
+        registerWatchTools(server, gitignoreFilter);
+    }
+    if (config.enableDatabase) {
+        registerListTodos(server);
+        await initDb(watchPath);
+        const files = collectFiles(watchPath, undefined, gitignoreFilter);
+        let totalTodos = 0;
+        for (const file of files) {
+            const todos = await scanFile(file);
+            if (todos.length > 0) {
+                const relFile = relative(watchPath, file);
+                const relTodos = todos.map((t) => ({ ...t, file: relFile }));
+                await syncFileTodos(relFile, relTodos);
+                totalTodos += todos.length;
+            }
+        }
+        const dbWatcher = watch(watchPath, {
+            ignored: (fp, stats) => {
+                const relPath = relative(watchPath, fp);
+                if (gitignoreFilter.ignores(relPath))
+                    return true;
+                if (stats?.isFile() && options.extensions) {
+                    const ext = '.' + fp.split('.').pop();
+                    return !options.extensions.includes(ext);
+                }
+                return false;
+            },
+            persistent: true,
+            ignoreInitial: true,
+        });
+        dbWatcher
+            .on('add', (p) => {
+            void (async () => {
+                const relPath = relative(watchPath, p);
+                try {
+                    const todos = await scanFile(p);
+                    await syncFileTodos(relPath, todos.map((t) => ({ ...t, file: relPath })));
+                }
+                catch { /* file may be temporarily unreadable */ }
+            })();
+        })
+            .on('change', (p) => {
+            void (async () => {
+                const relPath = relative(watchPath, p);
+                try {
+                    const todos = await scanFile(p);
+                    await syncFileTodos(relPath, todos.map((t) => ({ ...t, file: relPath })));
+                }
+                catch { /* file may be temporarily unreadable */ }
+            })();
+        })
+            .on('unlink', (p) => {
+            void removeFileTodos(relative(watchPath, p));
+        });
+        if (config.enableGetTodoStats) {
+            registerGetTodoStats(server);
+        }
+        return { server, totalTodos };
+    }
+    return { server, totalTodos: 0 };
+}
+//# sourceMappingURL=index.js.map