backlog-mcp 0.20.0 → 0.23.0

package/README.md

@@ -92,6 +92,21 @@ pnpm install && pnpm build
 pnpm start
 ```
 
+## Configuration
+
+Environment variables (create `.env` file for local development):
+
+```bash
+# Copy example config
+cp .env.example .env
+
+# Edit with your values
+BACKLOG_DATA_DIR=/Users/yourname/.backlog  # Where to store tasks
+BACKLOG_VIEWER_PORT=3030                    # HTTP server port
+```
+
+**For agents/LLMs:** Read the actual `.env` file to understand the configured values, not the defaults in code.
+
 ## Storage
 
 - Default: `data/tasks/` and `data/archive/` (local to project)

package/dist/cli/bridge.d.mts

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

package/dist/cli/bridge.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { paths } from "../utils/paths.mjs";
+import { ensureServer } from "./server-manager.mjs";
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+
+//#region src/cli/bridge.ts
+async function runBridge(port) {
+	await ensureServer(port);
+	const serverUrl = `http://localhost:${port}/mcp`;
+	const mcpRemotePath = paths.getBinPath("mcp-remote");
+	if (!existsSync(mcpRemotePath)) {
+		console.error("mcp-remote not found. Please run: pnpm install");
+		process.exit(1);
+	}
+	spawn(mcpRemotePath, [
+		serverUrl,
+		"--allow-http",
+		"--transport",
+		"http-only"
+	], { stdio: "inherit" }).on("exit", (code) => process.exit(code || 0));
+}
+runBridge(parseInt(process.env.BACKLOG_VIEWER_PORT || "3030")).catch((error) => {
+	console.error("Bridge error:", error);
+	process.exit(1);
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=bridge.mjs.map

package/dist/cli/bridge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.mjs","names":[],"sources":["../../src/cli/bridge.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { ensureServer } from './server-manager.js';\nimport { paths } from '@/utils/paths.js';\n\nasync function runBridge(port: number): Promise<void> {\n  await ensureServer(port);\n  \n  const serverUrl = `http://localhost:${port}/mcp`;\n  const mcpRemotePath = paths.getBinPath('mcp-remote');\n  \n  if (!existsSync(mcpRemotePath)) {\n    console.error('mcp-remote not found. Please run: pnpm install');\n    process.exit(1);\n  }\n  \n  const bridge = spawn(mcpRemotePath, [serverUrl, '--allow-http', '--transport', 'http-only'], {\n    stdio: 'inherit'\n  });\n  \n  bridge.on('exit', (code) => process.exit(code || 0));\n}\n\nconst port = parseInt(process.env.BACKLOG_VIEWER_PORT || '3030');\nrunBridge(port).catch((error) => {\n  console.error('Bridge error:', error);\n  process.exit(1);\n});\n"],"mappings":";;;;;;;AAOA,eAAe,UAAU,MAA6B;AACpD,OAAM,aAAa,KAAK;CAExB,MAAM,YAAY,oBAAoB,KAAK;CAC3C,MAAM,gBAAgB,MAAM,WAAW,aAAa;AAEpD,KAAI,CAAC,WAAW,cAAc,EAAE;AAC9B,UAAQ,MAAM,iDAAiD;AAC/D,UAAQ,KAAK,EAAE;;AAOjB,CAJe,MAAM,eAAe;EAAC;EAAW;EAAgB;EAAe;EAAY,EAAE,EAC3F,OAAO,WACR,CAAC,CAEK,GAAG,SAAS,SAAS,QAAQ,KAAK,QAAQ,EAAE,CAAC;;AAItD,UADa,SAAS,QAAQ,IAAI,uBAAuB,OAAO,CACjD,CAAC,OAAO,UAAU;AAC/B,SAAQ,MAAM,iBAAiB,MAAM;AACrC,SAAQ,KAAK,EAAE;EACf"}

package/dist/cli/index.d.mts

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

package/dist/{cli.js → cli/index.mjs}

@@ -1,18 +1,11 @@
 #!/usr/bin/env node
-try {
-    await import('dotenv/config');
-}
-catch { }
-const args = process.argv.slice(2);
-const command = args[0];
-if (command === 'serve') {
-    // HTTP server mode
-    const { startHttpServer } = await import('./http-server.js');
-    const port = parseInt(process.env.BACKLOG_VIEWER_PORT || '3030');
-    await startHttpServer(port);
-}
-else if (command === '--help' || command === '-h') {
-    console.log(`
+//#region src/cli/index.ts
+const command = process.argv.slice(2)[0];
+if (command === "serve") {
+	const { startHttpServer } = await import("../server/fastify-server.mjs");
+	await startHttpServer(parseInt(process.env.BACKLOG_VIEWER_PORT || "3030"));
+} else if (command === "--help" || command === "-h") {
+	console.log(`
 backlog-mcp - Task management MCP server
 
 Usage:
@@ -29,11 +22,9 @@ How it works:
   - HTTP server persists across sessions (shared by multiple clients)
   - Automatic version upgrades on server restart
   `);
-    process.exit(0);
-}
-else {
-    // Default: bridge mode (auto-spawn HTTP server)
-    await import('./cli/bridge.js');
-}
-export {};
-//# sourceMappingURL=cli.js.map
+	process.exit(0);
+} else await import("./bridge.mjs");
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.mjs.map

package/dist/cli/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/cli/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nconst args = process.argv.slice(2);\nconst command = args[0];\n\nif (command === 'serve') {\n  // HTTP server mode\n  const { startHttpServer } = await import('../server/fastify-server.js');\n  const port = parseInt(process.env.BACKLOG_VIEWER_PORT || '3030');\n  await startHttpServer(port);\n} else if (command === '--help' || command === '-h') {\n  console.log(`\nbacklog-mcp - Task management MCP server\n\nUsage:\n  backlog-mcp              Run as stdio MCP server (auto-bridges to HTTP server)\n  backlog-mcp serve        Run as HTTP MCP server with viewer\n  backlog-mcp --help       Show this help\n\nEnvironment variables:\n  BACKLOG_DATA_DIR         Data directory path (default: ./data)\n  BACKLOG_VIEWER_PORT      HTTP server port (default: 3030)\n\nHow it works:\n  - Default mode auto-spawns HTTP server and bridges stdio to it\n  - HTTP server persists across sessions (shared by multiple clients)\n  - Automatic version upgrades on server restart\n  `);\n  process.exit(0);\n} else {\n  // Default: bridge mode (auto-spawn HTTP server)\n  await import('./bridge.js');\n}\n"],"mappings":";;AAGA,MAAM,UADO,QAAQ,KAAK,MAAM,EAAE,CACb;AAErB,IAAI,YAAY,SAAS;CAEvB,MAAM,EAAE,oBAAoB,MAAM,OAAO;AAEzC,OAAM,gBADO,SAAS,QAAQ,IAAI,uBAAuB,OAAO,CACrC;WAClB,YAAY,YAAY,YAAY,MAAM;AACnD,SAAQ,IAAI;;;;;;;;;;;;;;;;IAgBV;AACF,SAAQ,KAAK,EAAE;MAGf,OAAM,OAAO"}

package/dist/cli/server-manager.d.mts

@@ -0,0 +1,5 @@
+//#region src/cli/server-manager.d.ts
+declare function ensureServer(port: number): Promise<void>;
+//#endregion
+export { ensureServer };
+//# sourceMappingURL=server-manager.d.mts.map

package/dist/cli/server-manager.mjs

@@ -0,0 +1,93 @@
+import { paths } from "../utils/paths.mjs";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+import { request } from "node:http";
+
+//#region src/cli/server-manager.ts
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function isServerRunning(port) {
+	return new Promise((resolve) => {
+		const req = request({
+			host: "localhost",
+			port,
+			path: "/version",
+			method: "GET"
+		}, (res) => {
+			resolve(res.statusCode === 200);
+		});
+		req.on("error", () => resolve(false));
+		req.end();
+	});
+}
+async function getServerVersion(port) {
+	return new Promise((resolve) => {
+		const req = request({
+			host: "localhost",
+			port,
+			path: "/version",
+			method: "GET"
+		}, (res) => {
+			if (res.statusCode !== 200) {
+				resolve(null);
+				return;
+			}
+			let data = "";
+			res.on("data", (chunk) => data += chunk);
+			res.on("end", () => resolve(data.trim()));
+		});
+		req.on("error", () => resolve(null));
+		req.end();
+	});
+}
+async function spawnServer(port) {
+	const serverPath = join(paths.distRoot, "server", "fastify-server.js");
+	spawn(process.execPath, [serverPath], {
+		detached: true,
+		stdio: "ignore",
+		env: {
+			...process.env,
+			BACKLOG_VIEWER_PORT: String(port)
+		}
+	}).unref();
+}
+async function shutdownServer(port) {
+	return new Promise((resolve) => {
+		const req = request({
+			host: "localhost",
+			port,
+			path: "/shutdown",
+			method: "POST"
+		}, () => {
+			resolve();
+		});
+		req.on("error", () => resolve());
+		req.end();
+	});
+}
+async function waitForServer(port, timeout) {
+	const start = Date.now();
+	let delay = 100;
+	while (Date.now() - start < timeout) {
+		if (await isServerRunning(port)) return;
+		await sleep(delay);
+		delay = Math.min(delay * 1.5, 1e3);
+	}
+	throw new Error(`Server failed to start within ${timeout}ms`);
+}
+async function ensureServer(port) {
+	if (!await isServerRunning(port)) {
+		await spawnServer(port);
+		await waitForServer(port, 1e4);
+		return;
+	}
+	if (await getServerVersion(port) !== paths.getVersion()) {
+		await shutdownServer(port);
+		await sleep(1e3);
+		await spawnServer(port);
+		await waitForServer(port, 1e4);
+	}
+}
+
+//#endregion
+export { ensureServer };
+//# sourceMappingURL=server-manager.mjs.map

package/dist/cli/server-manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-manager.mjs","names":[],"sources":["../../src/cli/server-manager.ts"],"sourcesContent":["import { request } from 'node:http';\nimport { spawn } from 'node:child_process';\nimport { join } from 'node:path';\nimport { paths } from '@/utils/paths.js';\n\nconst sleep = (ms: number) => new Promise(resolve => setTimeout(resolve, ms));\n\nasync function isServerRunning(port: number): Promise<boolean> {\n  return new Promise((resolve) => {\n    const req = request({ host: 'localhost', port, path: '/version', method: 'GET' }, (res) => {\n      resolve(res.statusCode === 200);\n    });\n    req.on('error', () => resolve(false));\n    req.end();\n  });\n}\n\nasync function getServerVersion(port: number): Promise<string | null> {\n  return new Promise((resolve) => {\n    const req = request({ host: 'localhost', port, path: '/version', method: 'GET' }, (res) => {\n      if (res.statusCode !== 200) {\n        resolve(null);\n        return;\n      }\n      let data = '';\n      res.on('data', chunk => data += chunk);\n      res.on('end', () => resolve(data.trim()));\n    });\n    req.on('error', () => resolve(null));\n    req.end();\n  });\n}\n\nasync function spawnServer(port: number): Promise<void> {\n  const serverPath = join(paths.distRoot, 'server', 'fastify-server.js');\n  const child = spawn(process.execPath, [serverPath], {\n    detached: true,\n    stdio: 'ignore',\n    env: { ...process.env, BACKLOG_VIEWER_PORT: String(port) }\n  });\n  child.unref();\n}\n\nasync function shutdownServer(port: number): Promise<void> {\n  return new Promise((resolve) => {\n    const req = request({ host: 'localhost', port, path: '/shutdown', method: 'POST' }, () => {\n      resolve();\n    });\n    req.on('error', () => resolve());\n    req.end();\n  });\n}\n\nasync function waitForServer(port: number, timeout: number): Promise<void> {\n  const start = Date.now();\n  let delay = 100;\n  \n  while (Date.now() - start < timeout) {\n    if (await isServerRunning(port)) return;\n    await sleep(delay);\n    delay = Math.min(delay * 1.5, 1000);\n  }\n  \n  throw new Error(`Server failed to start within ${timeout}ms`);\n}\n\nexport async function ensureServer(port: number): Promise<void> {\n  const running = await isServerRunning(port);\n  \n  if (!running) {\n    await spawnServer(port);\n    await waitForServer(port, 10000);\n    return;\n  }\n  \n  const serverVersion = await getServerVersion(port);\n  if (serverVersion !== paths.getVersion()) {\n    await shutdownServer(port);\n    await sleep(1000);\n    await spawnServer(port);\n    await waitForServer(port, 10000);\n  }\n}\n"],"mappings":";;;;;;AAKA,MAAM,SAAS,OAAe,IAAI,SAAQ,YAAW,WAAW,SAAS,GAAG,CAAC;AAE7E,eAAe,gBAAgB,MAAgC;AAC7D,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,MAAM,QAAQ;GAAE,MAAM;GAAa;GAAM,MAAM;GAAY,QAAQ;GAAO,GAAG,QAAQ;AACzF,WAAQ,IAAI,eAAe,IAAI;IAC/B;AACF,MAAI,GAAG,eAAe,QAAQ,MAAM,CAAC;AACrC,MAAI,KAAK;GACT;;AAGJ,eAAe,iBAAiB,MAAsC;AACpE,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,MAAM,QAAQ;GAAE,MAAM;GAAa;GAAM,MAAM;GAAY,QAAQ;GAAO,GAAG,QAAQ;AACzF,OAAI,IAAI,eAAe,KAAK;AAC1B,YAAQ,KAAK;AACb;;GAEF,IAAI,OAAO;AACX,OAAI,GAAG,SAAQ,UAAS,QAAQ,MAAM;AACtC,OAAI,GAAG,aAAa,QAAQ,KAAK,MAAM,CAAC,CAAC;IACzC;AACF,MAAI,GAAG,eAAe,QAAQ,KAAK,CAAC;AACpC,MAAI,KAAK;GACT;;AAGJ,eAAe,YAAY,MAA6B;CACtD,MAAM,aAAa,KAAK,MAAM,UAAU,UAAU,oBAAoB;AAMtE,CALc,MAAM,QAAQ,UAAU,CAAC,WAAW,EAAE;EAClD,UAAU;EACV,OAAO;EACP,KAAK;GAAE,GAAG,QAAQ;GAAK,qBAAqB,OAAO,KAAK;GAAE;EAC3D,CAAC,CACI,OAAO;;AAGf,eAAe,eAAe,MAA6B;AACzD,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,MAAM,QAAQ;GAAE,MAAM;GAAa;GAAM,MAAM;GAAa,QAAQ;GAAQ,QAAQ;AACxF,YAAS;IACT;AACF,MAAI,GAAG,eAAe,SAAS,CAAC;AAChC,MAAI,KAAK;GACT;;AAGJ,eAAe,cAAc,MAAc,SAAgC;CACzE,MAAM,QAAQ,KAAK,KAAK;CACxB,IAAI,QAAQ;AAEZ,QAAO,KAAK,KAAK,GAAG,QAAQ,SAAS;AACnC,MAAI,MAAM,gBAAgB,KAAK,CAAE;AACjC,QAAM,MAAM,MAAM;AAClB,UAAQ,KAAK,IAAI,QAAQ,KAAK,IAAK;;AAGrC,OAAM,IAAI,MAAM,iCAAiC,QAAQ,IAAI;;AAG/D,eAAsB,aAAa,MAA6B;AAG9D,KAAI,CAFY,MAAM,gBAAgB,KAAK,EAE7B;AACZ,QAAM,YAAY,KAAK;AACvB,QAAM,cAAc,MAAM,IAAM;AAChC;;AAIF,KADsB,MAAM,iBAAiB,KAAK,KAC5B,MAAM,YAAY,EAAE;AACxC,QAAM,eAAe,KAAK;AAC1B,QAAM,MAAM,IAAK;AACjB,QAAM,YAAY,KAAK;AACvB,QAAM,cAAc,MAAM,IAAM"}

package/dist/index.d.mts

@@ -0,0 +1,4 @@
+import { CreateTaskInput, STATUSES, Status, Task, createTask, formatTaskId, isValidTaskId, nextTaskId, parseTaskId } from "./storage/schema.mjs";
+import { storage } from "./storage/backlog.mjs";
+import { startHttpServer } from "./server/fastify-server.mjs";
+export { type CreateTaskInput, STATUSES, type Status, type Task, createTask, formatTaskId, isValidTaskId, nextTaskId, parseTaskId, startHttpServer, storage };

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import { STATUSES, createTask, formatTaskId, isValidTaskId, nextTaskId, parseTaskId } from "./storage/schema.mjs";
+import { storage } from "./storage/backlog.mjs";
+import { startHttpServer } from "./server/fastify-server.mjs";
+
+export { STATUSES, createTask, formatTaskId, isValidTaskId, nextTaskId, parseTaskId, startHttpServer, storage };

package/dist/middleware/auth.d.mts

@@ -0,0 +1,7 @@
+import { FastifyReply, FastifyRequest } from "fastify";
+
+//#region src/middleware/auth.d.ts
+declare function authMiddleware(request: FastifyRequest, reply: FastifyReply): Promise<undefined>;
+//#endregion
+export { authMiddleware };
+//# sourceMappingURL=auth.d.mts.map

package/dist/middleware/auth.mjs

@@ -0,0 +1,11 @@
+//#region src/middleware/auth.ts
+async function authMiddleware(request, reply) {
+	if (request.url === "/health" || request.url === "/version") return;
+	if (request.url.startsWith("/mcp") && process.env.API_KEY) {
+		if (request.headers.authorization !== `Bearer ${process.env.API_KEY}`) return reply.code(401).send({ error: "Unauthorized" });
+	}
+}
+
+//#endregion
+export { authMiddleware };
+//# sourceMappingURL=auth.mjs.map

package/dist/middleware/auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.mjs","names":[],"sources":["../../src/middleware/auth.ts"],"sourcesContent":["import type { FastifyRequest, FastifyReply } from 'fastify';\n\nexport async function authMiddleware(\n  request: FastifyRequest,\n  reply: FastifyReply\n) {\n  // Skip auth for health check and version\n  if (request.url === '/health' || request.url === '/version') {\n    return;\n  }\n\n  // API key auth for MCP endpoint (optional, for cloud deployment)\n  if (request.url.startsWith('/mcp') && process.env.API_KEY) {\n    const apiKey = request.headers.authorization;\n    if (apiKey !== `Bearer ${process.env.API_KEY}`) {\n      return reply.code(401).send({ error: 'Unauthorized' });\n    }\n  }\n}\n"],"mappings":";AAEA,eAAsB,eACpB,SACA,OACA;AAEA,KAAI,QAAQ,QAAQ,aAAa,QAAQ,QAAQ,WAC/C;AAIF,KAAI,QAAQ,IAAI,WAAW,OAAO,IAAI,QAAQ,IAAI,SAEhD;MADe,QAAQ,QAAQ,kBAChB,UAAU,QAAQ,IAAI,UACnC,QAAO,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,OAAO,gBAAgB,CAAC"}

package/dist/resources/index-resources.d.mts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/resources/index-resources.d.ts
+declare function registerResources(server: McpServer): void;
+//#endregion
+export { registerResources };
+//# sourceMappingURL=index-resources.d.mts.map

package/dist/resources/index-resources.mjs

@@ -0,0 +1,16 @@
+import { registerTasksResource } from "./tasks.mjs";
+import { registerTaskByIdResource } from "./task-by-id.mjs";
+import { registerTaskAttachedResource } from "./task-attached.mjs";
+import { registerResourceFileResource } from "./resource-file.mjs";
+
+//#region src/resources/index-resources.ts
+function registerResources(server) {
+	registerTasksResource(server);
+	registerTaskByIdResource(server);
+	registerTaskAttachedResource(server);
+	registerResourceFileResource(server);
+}
+
+//#endregion
+export { registerResources };
+//# sourceMappingURL=index-resources.mjs.map

package/dist/resources/index-resources.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-resources.mjs","names":[],"sources":["../../src/resources/index-resources.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { registerTasksResource } from './tasks.js';\nimport { registerTaskByIdResource } from './task-by-id.js';\nimport { registerTaskAttachedResource } from './task-attached.js';\nimport { registerResourceFileResource } from './resource-file.js';\n\nexport function registerResources(server: McpServer) {\n  registerTasksResource(server);\n  registerTaskByIdResource(server);\n  registerTaskAttachedResource(server);\n  registerResourceFileResource(server);\n}\n"],"mappings":";;;;;;AAMA,SAAgB,kBAAkB,QAAmB;AACnD,uBAAsB,OAAO;AAC7B,0BAAyB,OAAO;AAChC,8BAA6B,OAAO;AACpC,8BAA6B,OAAO"}

package/dist/resources/index.d.mts

@@ -0,0 +1,3 @@
+import { Operation, WriteResourceResult } from "./types.mjs";
+import { writeResource } from "./write.mjs";
+export { type Operation, type WriteResourceResult, writeResource };

package/dist/resources/index.mjs

@@ -0,0 +1,3 @@
+import { writeResource } from "./write.mjs";
+
+export { writeResource };

package/dist/resources/operations.d.mts

@@ -0,0 +1,7 @@
+import { Operation } from "./types.mjs";
+
+//#region src/resources/operations.d.ts
+declare function applyOperation(content: string, operation: Operation): string;
+//#endregion
+export { applyOperation };
+//# sourceMappingURL=operations.d.mts.map

package/dist/resources/operations.mjs

@@ -0,0 +1,26 @@
+//#region src/resources/operations.ts
+function applyOperation(content, operation) {
+	switch (operation.type) {
+		case "str_replace": {
+			const { old_str, new_str } = operation;
+			if (!content.includes(old_str)) throw new Error(`str_replace failed: old_str not found in content`);
+			return content.replace(old_str, new_str);
+		}
+		case "append": return content + operation.content;
+		case "prepend": return operation.content + content;
+		case "insert": {
+			const lines = content.split("\n");
+			if (operation.line < 0 || operation.line > lines.length) throw new Error(`insert failed: line ${operation.line} out of range (0-${lines.length})`);
+			lines.splice(operation.line, 0, operation.content);
+			return lines.join("\n");
+		}
+		case "delete":
+			if (!content.includes(operation.content)) throw new Error(`delete failed: content not found`);
+			return content.replace(operation.content, "");
+		default: throw new Error(`Unknown operation type: ${operation.type}`);
+	}
+}
+
+//#endregion
+export { applyOperation };
+//# sourceMappingURL=operations.mjs.map

package/dist/resources/operations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.mjs","names":[],"sources":["../../src/resources/operations.ts"],"sourcesContent":["// Apply operations to text content\n\nimport type { Operation } from './types.js';\n\nexport function applyOperation(content: string, operation: Operation): string {\n  switch (operation.type) {\n    case 'str_replace': {\n      const { old_str, new_str } = operation;\n      if (!content.includes(old_str)) {\n        throw new Error(`str_replace failed: old_str not found in content`);\n      }\n      return content.replace(old_str, new_str);\n    }\n\n    case 'append': {\n      return content + operation.content;\n    }\n\n    case 'prepend': {\n      return operation.content + content;\n    }\n\n    case 'insert': {\n      const lines = content.split('\\n');\n      if (operation.line < 0 || operation.line > lines.length) {\n        throw new Error(`insert failed: line ${operation.line} out of range (0-${lines.length})`);\n      }\n      lines.splice(operation.line, 0, operation.content);\n      return lines.join('\\n');\n    }\n\n    case 'delete': {\n      if (!content.includes(operation.content)) {\n        throw new Error(`delete failed: content not found`);\n      }\n      return content.replace(operation.content, '');\n    }\n\n    default:\n      throw new Error(`Unknown operation type: ${(operation as any).type}`);\n  }\n}\n"],"mappings":";AAIA,SAAgB,eAAe,SAAiB,WAA8B;AAC5E,SAAQ,UAAU,MAAlB;EACE,KAAK,eAAe;GAClB,MAAM,EAAE,SAAS,YAAY;AAC7B,OAAI,CAAC,QAAQ,SAAS,QAAQ,CAC5B,OAAM,IAAI,MAAM,mDAAmD;AAErE,UAAO,QAAQ,QAAQ,SAAS,QAAQ;;EAG1C,KAAK,SACH,QAAO,UAAU,UAAU;EAG7B,KAAK,UACH,QAAO,UAAU,UAAU;EAG7B,KAAK,UAAU;GACb,MAAM,QAAQ,QAAQ,MAAM,KAAK;AACjC,OAAI,UAAU,OAAO,KAAK,UAAU,OAAO,MAAM,OAC/C,OAAM,IAAI,MAAM,uBAAuB,UAAU,KAAK,mBAAmB,MAAM,OAAO,GAAG;AAE3F,SAAM,OAAO,UAAU,MAAM,GAAG,UAAU,QAAQ;AAClD,UAAO,MAAM,KAAK,KAAK;;EAGzB,KAAK;AACH,OAAI,CAAC,QAAQ,SAAS,UAAU,QAAQ,CACtC,OAAM,IAAI,MAAM,mCAAmC;AAErD,UAAO,QAAQ,QAAQ,UAAU,SAAS,GAAG;EAG/C,QACE,OAAM,IAAI,MAAM,2BAA4B,UAAkB,OAAO"}

package/dist/resources/resource-file.d.mts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/resources/resource-file.d.ts
+declare function registerResourceFileResource(server: McpServer): void;
+//#endregion
+export { registerResourceFileResource };
+//# sourceMappingURL=resource-file.d.mts.map

package/dist/resources/resource-file.mjs

@@ -0,0 +1,20 @@
+import { readMcpResource } from "./resource-reader.mjs";
+
+//#region src/resources/resource-file.ts
+function registerResourceFileResource(server) {
+	server.registerResource("Resource File", "mcp://backlog/resources/{path}", {
+		description: "Read a resource file",
+		mimeType: "text/plain"
+	}, async (uri) => {
+		const resource = await readMcpResource(uri.toString());
+		return { contents: [{
+			uri: uri.toString(),
+			mimeType: resource.mimeType,
+			text: resource.content
+		}] };
+	});
+}
+
+//#endregion
+export { registerResourceFileResource };
+//# sourceMappingURL=resource-file.mjs.map

package/dist/resources/resource-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-file.mjs","names":[],"sources":["../../src/resources/resource-file.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { readMcpResource } from './resource-reader.js';\n\nexport function registerResourceFileResource(server: McpServer) {\n  server.registerResource(\n    'Resource File',\n    'mcp://backlog/resources/{path}',\n    { description: 'Read a resource file', mimeType: 'text/plain' },\n    async (uri: URL) => {\n      const resource = await readMcpResource(uri.toString());\n      return { contents: [{ uri: uri.toString(), mimeType: resource.mimeType, text: resource.content }] };\n    }\n  );\n}\n"],"mappings":";;;AAGA,SAAgB,6BAA6B,QAAmB;AAC9D,QAAO,iBACL,iBACA,kCACA;EAAE,aAAa;EAAwB,UAAU;EAAc,EAC/D,OAAO,QAAa;EAClB,MAAM,WAAW,MAAM,gBAAgB,IAAI,UAAU,CAAC;AACtD,SAAO,EAAE,UAAU,CAAC;GAAE,KAAK,IAAI,UAAU;GAAE,UAAU,SAAS;GAAU,MAAM,SAAS;GAAS,CAAC,EAAE;GAEtG"}

package/dist/resources/resource-reader.d.mts

@@ -0,0 +1,10 @@
+//#region src/resources/resource-reader.d.ts
+interface ResourceContent {
+  content: string;
+  frontmatter?: Record<string, any>;
+  mimeType: string;
+}
+declare function readMcpResource(uri: string): ResourceContent;
+//#endregion
+export { ResourceContent, readMcpResource };
+//# sourceMappingURL=resource-reader.d.mts.map

package/dist/resources/resource-reader.mjs

@@ -0,0 +1,34 @@
+import { resolveMcpUri } from "../utils/uri-resolver.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import matter from "gray-matter";
+
+//#region src/resources/resource-reader.ts
+function readMcpResource(uri) {
+	const filePath = resolveMcpUri(uri);
+	if (!existsSync(filePath)) throw new Error(`Resource not found: ${uri}`);
+	const content = readFileSync(filePath, "utf-8");
+	const ext = filePath.split(".").pop()?.toLowerCase() || "txt";
+	const mimeType = {
+		md: "text/markdown",
+		json: "application/json",
+		ts: "text/typescript",
+		js: "application/javascript",
+		txt: "text/plain"
+	}[ext] || "text/plain";
+	if (ext === "md") {
+		const parsed = matter(content);
+		return {
+			content: parsed.content,
+			frontmatter: parsed.data,
+			mimeType
+		};
+	}
+	return {
+		content,
+		mimeType
+	};
+}
+
+//#endregion
+export { readMcpResource };
+//# sourceMappingURL=resource-reader.mjs.map

package/dist/resources/resource-reader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-reader.mjs","names":[],"sources":["../../src/resources/resource-reader.ts"],"sourcesContent":["import { readFileSync, existsSync } from 'node:fs';\nimport matter from 'gray-matter';\nimport { resolveMcpUri } from '../utils/uri-resolver.js';\n\nexport interface ResourceContent {\n  content: string;\n  frontmatter?: Record<string, any>;\n  mimeType: string;\n}\n\nexport function readMcpResource(uri: string): ResourceContent {\n  const filePath = resolveMcpUri(uri);\n  \n  if (!existsSync(filePath)) {\n    throw new Error(`Resource not found: ${uri}`);\n  }\n  \n  const content = readFileSync(filePath, 'utf-8');\n  const ext = filePath.split('.').pop()?.toLowerCase() || 'txt';\n  \n  const mimeMap: Record<string, string> = {\n    md: 'text/markdown',\n    json: 'application/json',\n    ts: 'text/typescript',\n    js: 'application/javascript',\n    txt: 'text/plain',\n  };\n  \n  const mimeType = mimeMap[ext] || 'text/plain';\n  \n  // Parse frontmatter for markdown files\n  if (ext === 'md') {\n    const parsed = matter(content);\n    return {\n      content: parsed.content,\n      frontmatter: parsed.data,\n      mimeType,\n    };\n  }\n  \n  return {\n    content,\n    mimeType,\n  };\n}\n"],"mappings":";;;;;AAUA,SAAgB,gBAAgB,KAA8B;CAC5D,MAAM,WAAW,cAAc,IAAI;AAEnC,KAAI,CAAC,WAAW,SAAS,CACvB,OAAM,IAAI,MAAM,uBAAuB,MAAM;CAG/C,MAAM,UAAU,aAAa,UAAU,QAAQ;CAC/C,MAAM,MAAM,SAAS,MAAM,IAAI,CAAC,KAAK,EAAE,aAAa,IAAI;CAUxD,MAAM,WARkC;EACtC,IAAI;EACJ,MAAM;EACN,IAAI;EACJ,IAAI;EACJ,KAAK;EACN,CAEwB,QAAQ;AAGjC,KAAI,QAAQ,MAAM;EAChB,MAAM,SAAS,OAAO,QAAQ;AAC9B,SAAO;GACL,SAAS,OAAO;GAChB,aAAa,OAAO;GACpB;GACD;;AAGH,QAAO;EACL;EACA;EACD"}

package/dist/resources/task-attached.d.mts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/resources/task-attached.d.ts
+declare function registerTaskAttachedResource(server: McpServer): void;
+//#endregion
+export { registerTaskAttachedResource };
+//# sourceMappingURL=task-attached.d.mts.map

package/dist/resources/task-attached.mjs

@@ -0,0 +1,17 @@
+import { readMcpResource } from "./resource-reader.mjs";
+
+//#region src/resources/task-attached.ts
+function registerTaskAttachedResource(server) {
+	server.registerResource("Task-Attached Resource", "mcp://backlog/resources/{taskId}/{filename}", { description: "Task-attached resources (ADRs, design docs, etc.)" }, async (uri) => {
+		const { content, mimeType } = await readMcpResource(uri.toString());
+		return { contents: [{
+			uri: uri.toString(),
+			mimeType,
+			text: content
+		}] };
+	});
+}
+
+//#endregion
+export { registerTaskAttachedResource };
+//# sourceMappingURL=task-attached.mjs.map

package/dist/resources/task-attached.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-attached.mjs","names":[],"sources":["../../src/resources/task-attached.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { readMcpResource } from './resource-reader.js';\n\nexport function registerTaskAttachedResource(server: McpServer) {\n  server.registerResource(\n    'Task-Attached Resource',\n    'mcp://backlog/resources/{taskId}/{filename}',\n    { description: 'Task-attached resources (ADRs, design docs, etc.)' },\n    async (uri: URL) => {\n      const { content, mimeType } = await readMcpResource(uri.toString());\n      return { contents: [{ uri: uri.toString(), mimeType, text: content }] };\n    }\n  );\n}\n"],"mappings":";;;AAGA,SAAgB,6BAA6B,QAAmB;AAC9D,QAAO,iBACL,0BACA,+CACA,EAAE,aAAa,qDAAqD,EACpE,OAAO,QAAa;EAClB,MAAM,EAAE,SAAS,aAAa,MAAM,gBAAgB,IAAI,UAAU,CAAC;AACnE,SAAO,EAAE,UAAU,CAAC;GAAE,KAAK,IAAI,UAAU;GAAE;GAAU,MAAM;GAAS,CAAC,EAAE;GAE1E"}

package/dist/resources/task-by-id.d.mts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/resources/task-by-id.d.ts
+declare function registerTaskByIdResource(server: McpServer): void;
+//#endregion
+export { registerTaskByIdResource };
+//# sourceMappingURL=task-by-id.d.mts.map

package/dist/resources/task-by-id.mjs

@@ -0,0 +1,23 @@
+import { storage } from "../storage/backlog.mjs";
+
+//#region src/resources/task-by-id.ts
+function registerTaskByIdResource(server) {
+	server.registerResource("Task by ID", "mcp://backlog/tasks/{taskId}/file", {
+		description: "Get a specific task",
+		mimeType: "text/markdown"
+	}, async (uri) => {
+		const match = uri.toString().match(/mcp:\/\/backlog\/tasks\/([^/]+)\/file/);
+		if (!match || !match[1]) throw new Error("Invalid URI");
+		const markdown = storage.getMarkdown(match[1]);
+		if (!markdown) throw new Error("Task not found");
+		return { contents: [{
+			uri: uri.toString(),
+			mimeType: "text/markdown",
+			text: markdown
+		}] };
+	});
+}
+
+//#endregion
+export { registerTaskByIdResource };
+//# sourceMappingURL=task-by-id.mjs.map

package/dist/resources/task-by-id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-by-id.mjs","names":[],"sources":["../../src/resources/task-by-id.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { storage } from '../storage/backlog.js';\n\nexport function registerTaskByIdResource(server: McpServer) {\n  server.registerResource(\n    'Task by ID',\n    'mcp://backlog/tasks/{taskId}/file',\n    { description: 'Get a specific task', mimeType: 'text/markdown' },\n    async (uri: URL) => {\n      const match = uri.toString().match(/mcp:\\/\\/backlog\\/tasks\\/([^/]+)\\/file/);\n      if (!match || !match[1]) throw new Error('Invalid URI');\n      const markdown = storage.getMarkdown(match[1]);\n      if (!markdown) throw new Error('Task not found');\n      return { contents: [{ uri: uri.toString(), mimeType: 'text/markdown', text: markdown }] };\n    }\n  );\n}\n"],"mappings":";;;AAGA,SAAgB,yBAAyB,QAAmB;AAC1D,QAAO,iBACL,cACA,qCACA;EAAE,aAAa;EAAuB,UAAU;EAAiB,EACjE,OAAO,QAAa;EAClB,MAAM,QAAQ,IAAI,UAAU,CAAC,MAAM,wCAAwC;AAC3E,MAAI,CAAC,SAAS,CAAC,MAAM,GAAI,OAAM,IAAI,MAAM,cAAc;EACvD,MAAM,WAAW,QAAQ,YAAY,MAAM,GAAG;AAC9C,MAAI,CAAC,SAAU,OAAM,IAAI,MAAM,iBAAiB;AAChD,SAAO,EAAE,UAAU,CAAC;GAAE,KAAK,IAAI,UAAU;GAAE,UAAU;GAAiB,MAAM;GAAU,CAAC,EAAE;GAE5F"}

package/dist/resources/tasks.d.mts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/resources/tasks.d.ts
+declare function registerTasksResource(server: McpServer): void;
+//#endregion
+export { registerTasksResource };
+//# sourceMappingURL=tasks.d.mts.map

package/dist/resources/tasks.mjs

@@ -0,0 +1,20 @@
+import { storage } from "../storage/backlog.mjs";
+
+//#region src/resources/tasks.ts
+function registerTasksResource(server) {
+	server.registerResource("All Tasks", "mcp://backlog/tasks", {
+		description: "List of all tasks",
+		mimeType: "application/json"
+	}, async () => {
+		const tasks = storage.list({});
+		return { contents: [{
+			uri: "mcp://backlog/tasks",
+			mimeType: "application/json",
+			text: JSON.stringify(tasks, null, 2)
+		}] };
+	});
+}
+
+//#endregion
+export { registerTasksResource };
+//# sourceMappingURL=tasks.mjs.map

package/dist/resources/tasks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.mjs","names":[],"sources":["../../src/resources/tasks.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { storage } from '../storage/backlog.js';\n\nexport function registerTasksResource(server: McpServer) {\n  server.registerResource(\n    'All Tasks',\n    'mcp://backlog/tasks',\n    { description: 'List of all tasks', mimeType: 'application/json' },\n    async () => {\n      const tasks = storage.list({});\n      return { contents: [{ uri: 'mcp://backlog/tasks', mimeType: 'application/json', text: JSON.stringify(tasks, null, 2) }] };\n    }\n  );\n}\n"],"mappings":";;;AAGA,SAAgB,sBAAsB,QAAmB;AACvD,QAAO,iBACL,aACA,uBACA;EAAE,aAAa;EAAqB,UAAU;EAAoB,EAClE,YAAY;EACV,MAAM,QAAQ,QAAQ,KAAK,EAAE,CAAC;AAC9B,SAAO,EAAE,UAAU,CAAC;GAAE,KAAK;GAAuB,UAAU;GAAoB,MAAM,KAAK,UAAU,OAAO,MAAM,EAAE;GAAE,CAAC,EAAE;GAE5H"}

package/dist/resources/types.d.mts

@@ -0,0 +1,33 @@
+//#region src/resources/types.d.ts
+type OperationType = 'str_replace' | 'append' | 'prepend' | 'insert' | 'delete';
+interface StrReplaceOperation {
+  type: 'str_replace';
+  old_str: string;
+  new_str: string;
+}
+interface AppendOperation {
+  type: 'append';
+  content: string;
+}
+interface PrependOperation {
+  type: 'prepend';
+  content: string;
+}
+interface InsertOperation {
+  type: 'insert';
+  line: number;
+  content: string;
+}
+interface DeleteOperation {
+  type: 'delete';
+  content: string;
+}
+type Operation = StrReplaceOperation | AppendOperation | PrependOperation | InsertOperation | DeleteOperation;
+interface WriteResourceResult {
+  success: boolean;
+  message: string;
+  error?: string;
+}
+//#endregion
+export { AppendOperation, DeleteOperation, InsertOperation, Operation, OperationType, PrependOperation, StrReplaceOperation, WriteResourceResult };
+//# sourceMappingURL=types.d.mts.map

package/dist/resources/types.mjs

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

package/dist/resources/uri.d.mts

@@ -0,0 +1,11 @@
+//#region src/resources/uri.d.ts
+interface ParsedURI {
+  server: string;
+  resource: string;
+  taskId?: string;
+  field?: string;
+}
+declare function parseURI(uri: string): ParsedURI | null;
+//#endregion
+export { ParsedURI, parseURI };
+//# sourceMappingURL=uri.d.mts.map

package/dist/resources/uri.mjs

@@ -0,0 +1,22 @@
+//#region src/resources/uri.ts
+function parseURI(uri) {
+	const match = uri.match(/^mcp:\/\/([^\/]+)\/(.+)$/);
+	if (!match) return null;
+	const [, server, resource] = match;
+	if (!server || !resource) return null;
+	const taskMatch = resource.match(/^tasks\/([^\/]+)(?:\/(description|file))?$/);
+	if (taskMatch) return {
+		server,
+		resource,
+		taskId: taskMatch[1],
+		field: taskMatch[2] || "file"
+	};
+	return {
+		server,
+		resource
+	};
+}
+
+//#endregion
+export { parseURI };
+//# sourceMappingURL=uri.mjs.map

package/dist/resources/uri.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.mjs","names":[],"sources":["../../src/resources/uri.ts"],"sourcesContent":["// URI parser for mcp:// scheme\n\nexport interface ParsedURI {\n  server: string;\n  resource: string;\n  taskId?: string;\n  field?: string;\n}\n\nexport function parseURI(uri: string): ParsedURI | null {\n  // Expected format: mcp://backlog/{resource}\n  const match = uri.match(/^mcp:\\/\\/([^\\/]+)\\/(.+)$/);\n  if (!match) return null;\n\n  const [, server, resource] = match;\n  \n  if (!server || !resource) return null;\n  \n  // Check if it's a task field edit: tasks/{id}/description or tasks/{id}/file\n  const taskMatch = resource.match(/^tasks\\/([^\\/]+)(?:\\/(description|file))?$/);\n  if (taskMatch) {\n    return {\n      server,\n      resource,\n      taskId: taskMatch[1],\n      field: taskMatch[2] || 'file',\n    };\n  }\n\n  // General resource (artifacts, resources, etc.)\n  return {\n    server,\n    resource,\n  };\n}\n"],"mappings":";AASA,SAAgB,SAAS,KAA+B;CAEtD,MAAM,QAAQ,IAAI,MAAM,2BAA2B;AACnD,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,GAAG,QAAQ,YAAY;AAE7B,KAAI,CAAC,UAAU,CAAC,SAAU,QAAO;CAGjC,MAAM,YAAY,SAAS,MAAM,6CAA6C;AAC9E,KAAI,UACF,QAAO;EACL;EACA;EACA,QAAQ,UAAU;EAClB,OAAO,UAAU,MAAM;EACxB;AAIH,QAAO;EACL;EACA;EACD"}